adTempus API
|
Parses an XML document to prepare it for import.
HRESULT ParseXML(BSTR importXML, [out,retval] IImportParameters ** parameters);
ParseXML(String importXML, [out,retval] IImportParameters * parameters);
Sub ParseXML(importXML As String, parameters As [out,retval] IImportParameters *)
Parameters |
Description |
[in] BSTR importXML |
The XML to import. This XML must have been created using the ExportToXML method and must conform to the XML schema for adTempus export files. |
[out,retval] IImportParameters ** parameters |
On return, contains an IImportParameters object that can be used in a call to ImportData. |
ParseXML reads and validates an XML file in preparation for import. If the XML data is valid, ParseXML returns an IImportParameters collection, which contains an IObjectImportParameters object for each object found in the document. You may then review the settings for the objects before passing this collection to ImportData, which performs the import.
When ParseXML reads the file, it checks each object to see whether it already exists in adTempus and sets the State property of each IObjectImportParameters object.
State |
Meaning |
The object does not already exist. | |
An object with the same OID already exists. | |
An object with a different OID but the same primary key already exists. |
By default the import action for each object is set to Import, except that CredentialProfiles with a State of Existing or Duplicate are set to Skip.
When an object has a state of Duplicate, this indicates that an object with the same primary key but a different OID already exists. For example, if a NotificationIndividual is marked Duplicate, a NotificationIndividual already exists with the same name but a different OID. When duplicate objects are imported, adTempus updates the existing object with the data from the import source rather than importing the duplicate object. The existing object's OID does not change.
To import only selected objects, set the Action to Skip for the objects you do not want to import. Note that an object that is marked as Skip will still be imported if it is referenced by an object that is being imported and if its State is New.
adTempus API Reference version 3.0.0.0, revised 10/30/2008
|